package com.ruoyi.common.core.mapper.servicemanager;
import com.ruoyi.common.core.domain.servicemanage.Coupon;
import com.ruoyi.common.core.domain.servicemanage.vo.CouponTemplateVo;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 服务优惠卷Mapper接口
 *
 * @author ruoyi
 * @date 2025-06-23
 */
public interface CouponMapper
{
    /**
     * 查询服务优惠卷
     *
     * @param id 服务优惠卷主键
     * @return 服务优惠卷
     */
    public Coupon selectCouponById(String id);

    /**
     * 查询服务优惠卷列表
     *
     * @param coupon 服务优惠卷
     * @return 服务优惠卷集合
     */
    public List<Coupon> selectCouponList(Coupon coupon);

    /**
     * 新增服务优惠卷
     *
     * @param coupon 服务优惠卷
     * @return 结果
     */
    public int insertCoupon(Coupon coupon);

    /**
     * 修改服务优惠卷
     *
     * @param coupon 服务优惠卷
     * @return 结果
     */
    public int updateCoupon(Coupon coupon);

    /**
     * 删除服务优惠卷
     *
     * @param id 服务优惠卷主键
     * @return 结果
     */
    public int deleteCouponById(String id);

    /**
     * 批量删除服务优惠卷
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteCouponByIds(String[] ids);

    /**
     * 多表联查优惠券及模板信息，带条件
     * @param userId 用户编号
     * @param status 优惠券状态
     * @param createTime 获取时间（可为null）
     * @param useTime 过期时间（可为null）
     * @return 优惠券模板VO集合
     */
    List<CouponTemplateVo> selectCouponWithTemplate(CouponTemplateVo query);
}

